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REFERENCE GUIDE NOTATIONS AND 
FORMAT CONVENTIONS 


This reference guide employs a standard scheme for presenting the general format of BASIC 


language statements. The capitalization, punctuation and other conventions are listed below: 
[ ] Brackets indicate that the enclosed items Line number A line number is implied for all 


are optional, Brackets do not appear in 
the actual statements. 

{ } Braces indicate that a choice of one of 
the enclosed items is to be made. Braces 
do not appear in the actual statements. 

. . Ellipses indicate that the preceding item 
may be repeated. Ellipses do not appear 
in the actual statements. 

italics Italics indicate generic terms. The 
programmer must supply the actual value 
or wording required. See Generic Terms 
and Abbreviations. 


BASIC language statements entered in 
program mode. 

Punctuation All punctuation characters, 
including commas, semicolons, colons, 
quotation marks, and parentheses must 
appear as indicated. 

UPPERCASE Uppercase letters and words 
must appear exactly as indicated. 


BASIC PROGRAMMING MODES 


IMMEDIATE Statement entered without a 
line number will be immediately executed 
by BASIC. Also known as ‘‘command” 
mode 


PROGRAM Statement(s) entered with line 


numbers will be executed by RUN and 
ENTER in numerical order. 


BASIC STATEMENT FORMAT 


Maximum line length is 704 characters on 22 physical lines of 32 characters per line to include the line 


number, 


Immediate Mode format: statement |: statement 
Program Mode format: line number [: statement 


J 
] 


GENERIC TERMS, ABBREVIATIONS 


AND DE 


array A-set of variables that has the same 
name and that are distinguished by a number 
known as the subscript written in parenthesis 
after the name. An array can have as many 
values as there are elements, with each ele- 
ment of the array having a separate value. 
border The edge of the screen. 
concatenation The joining together of two 
strings in a specified order. 

cursor A moveable display marker that in- 
dicates how the computer is going to interpret 


the next key entered or if a syntax error has oc- 


curred 

element The value assigned to a subscript. 
expr Any valid expression. 

expr$ Any valid string constant, variable, or 
expression. 

exprnm Any numeric constant, variable, or 
expression, 

format The structure of the BASIC command 
or statement. 

INK The color of the printed characters and 
symbols printed on the screen. Also known as 
foreground. 

letter Any one of the 26 alphabetic 
characters. 

letterS Any one of the 26 alphabetic 
characters followed by a dollar sign ($), which 
signifies a string name. 


line A BASIC program line number between 
1 and 9999. 

list A list of constants, variables, or 
expressions. 


FINITIONS 


m_ Acolumn on the screen between 0 and 31 
used to position where characters and graphic 
symbols are to be displayed. The value can be 
expressed as a numeric value, variable, or 
expression. 

memadr A memory address referenced by a 
numeric expression, variable, or constant. 

n_ Aline on the screen between 0 and 21 
used to position where characters and graphic 
symbols are to be displayed. The value can be 
expressed as a numeric value, variable, or 
expression. 

PAPER The color of the screen. Also known 
as background. 

program name An identifying name given to 
a program that can be up to 10 characters long 
to include spaces. 

radius The radius of a circle expressed as a 
numeric value, variable, or expression. 

scalar A variable that has only one value at a 
given time. 

scroll? |s a question the computer asks you 
when the screen has all lines filled and you 
decide whether to stop or continue the execu- 
tion of the program. 

slicing Operation to obtain a substring from a 
string. 

statement A BASIC language equivalent of 
an English sentence. 

string A group of characters beginning and 
ending with quotation marks that is treated by 
the computer as a single item. 

subscript A number or numeric expression 


GENERIC TERMS, ABBREVIATIONS AND DEFINITIONS (continued) 


which, when evaluated, identifies a particular 
element in an array. 

x-coordinate The position of a pixel with 
respect to the left-hand column of the screen. 


The specified value must be between @ and 255. 


y-coordinate The position of a pixel with 
respect to the bottom of the screen. 

var Numeric or string variable. The specified 
value must be between @ and 175. 


CURSOR DISPLAY MODES 


Ea Keyword (token) mode: indicates that the 
computer is expecting a keyword 
command or number located on the key. 

Letter mode: means the computer will 
interpret any key pressed as the main 


letter or number (large symbol) on the key. 


If unshifted, the key will be interpreted as 
a lowercase letter. If shifted, the key will 
be interpreted as an uppercase letter, 

(Capital mode: means that all letters will 
appear as capitals. CAPS LOCK causes a 
change from mode to [4 mode or 
back again. 

TG sExtended mode: means that a key gives a 

: token above it if unshifted, and another 
token below it if pressed together with 
either shift key. A digit key gives a token if 
pressed with SYMBOL SHIFT; otherwise it 


KEYBOARD 


gives a color control sequence. 
mode occurs after CAPS SHIFT and 
SYMBOL SHIFT keys are pressed 
together and lasts for one key depression 
only. 

fl Graphics mode: permits graphics 
characters on the digit keys and user 
defined graphics on all letter keys except 
V through Z to be displayed. The Graphics 
mode is entered by pressing CAPS SHIFT 
and 9 key and lasts until this two key 
sequence Is pressed again. 

fa Syntax error marker: denotes an 
unacceptable format for the data that was 
entered. 

Eas Program cursor: indicates the line most 
recently entered or accessed. 


UTILIZATION 


CAPSLOCK TRUE VOEO 


BORER aoHaS 
HIBS 


STK ON Efe 


LPrONT 


TIMEX SINCLAIR 2068 
KEYBOARD 


KEY FORMAT 


FUNCTION or COMMAND Pressing CAPS 
SHIFT and SYMBOL SHIFT at the same 
time causes the cursor to change 
to [@ for extended mode. When in this 
mode, the function or command written 
on the keyboard above each key can be 
entered by pressing the key. The function 
or command written on the keyboard 
below each key can be entered by 
simultaneously pressing either shift key 
and the desired key when in extended 
mode. 

LETTER English alphabet (A through Z) 
and numerics (0 through 9) can be 
entered as individual characters when 


ac —aelele 


——— 


SCREENS ATT 


FUNCTION OR COMMAND 
utter 


LYWORD ON MEW 
GRASS SYM 


FUNCTION OF COMMAND 


DATA ENTRY 


the or {4 cursor is displayed. All 
alphabetic characters entered in 
lowercase unless CAPS SHIFT held down 
or [GJ cursor is displayed when entering 
character. Pressing CAPS SHIFT and 
alphabetic character when [JM cursor is 
displayed or when {J cursor is 
displayed results in a capital letter being 
entered. 

KEYWORD ON KEY A BASIC statement 
entered pressing the appropriate key 
when | cursor is displayed. After 
keyword Is entered, the cursor will 

automatically shift to 


DATA ENTRY (continued) 


GRAPHIC SYMBOL The graphic symbols on symbol! to be displayed. Exit graphics 
the number keys in the top row of the mode by pressing 9 key. 
keyboard can be entered by first pressing) WORD OR SYMBOL! Pressi 
CAPS SHIFT and the 9 key simultaneously SYMBOL SHIFT wile n a ; 
to obtain graphics mode __ Cursor. or mode and key enters the word or 
Then, typing any of the keys with a symbol in the band on the key. 
graphic symbol! on them will cause that 


DATA ENTRY AND CURSOR DISPLAY MODES 


DATA 


Co Keyword Press numeric key(s). Line number | 

Keyword Press key. keyword on key 

D Letter Press key. Numeric or lowercase letter 

Letter Press CAPS SHIFT Numeric or uppercase letter Gg 
plus 2 then key. 

Uppercase Press alphabetic key Uppercase letter 

Uppercase = Press CAPS SHIFT plus 2 Letter mode 
then key. 

G Letter Press CAPS SHIFT plus 9. Graphics mode ia} 

Graphics Press numeric key, Graphic symbol o 

Graphics Press 9. Letter mode 

Graphics Press CAPS SHIFT Inverse graphic symbol o 

Letter Press CAPS SHIFT and extended mode a 
SYMBOL SHIFT. 

G Extended Press key Words written on 

keyboard above key 

GseExtended Press SYMBOL SHIFT —- Function or comand written 
and key. under key 

G seExtended Press CAPS SHIFT and Returns to previous mode 


SYMBOL SHIFT. 


DISPLAY INDICATORS 


Last Line Entered Previous program line 
ENTERed by pressing ENTER key. 

Current Line Program line you are entering. 
Once ENTERed, current line becomes last line 
entered. 

Report A code that reports success or failure 
of an operation. 


Ei Last tine entered (program line) 
of line being edited 


report or current line work area 


DISPLAY CONTROL 


)PERATIONAL RES! 


Deletes the character or ki rd immediately to the left of the 
cursor when the or [J cursor is on the screen. 


Moves the (program line) pointed to by the cursor into the work 
area at the bottom of the screen for editing. 


Turns CAPS LOCK on or off 


Changes the display to TRUE VIDEO where characters are printed 
in the ink color on a paper color background. 


Changes the display to INVERSE VIDEO where characters are 
printed in paper color on an ink color background 


Moves the cursor to the left one position 


CAPS SHIFT and 0 
CAPS SHIFT and 1 


CAPS SHIFT and 2 
CAPS SHIFT and 3 


CAPS SHIFT and 4 


CAPS SHIFT and 5 


VARIABLE NAMING CONVENTIONS 


Scalar Variable format F {s} where: 
First character must be a letter; 
Second character must be a dollar sign ($) 
if string variable; otherwise may be where: exprnm,, defines the length 
a letter or digit. of the string array in characters 
Name length: one letter and dollar sign ($) Note: all array subscripts start at 1 
if string variable; any number of letters Example: A%$(5,3) specifies 3rd_ 
and digits if numeric variable. letter of AS(5) or a string array 


f 5 elements, each 3 
Array Variable formats oO tS, 
NUMERIC ARRAY format characters in length. 


ARITHMETIC OPERATORS 


Operation 


ARITHMETIC 
Exponentation ! 
Unary Minus ~ 
Multiplication * 
Division / 
+ 


Letter (exprnm [, exprnm. . . }) 


STRING ARRAY format 
Letter (exprnm,[,. ._ exprnm,,]) 


Addition 


Subtraction 


M4 
J 
8B 
V 
K 
J 
RELATIONAL 
Equal = L 

w 

a 

Q 

T 

E 


Not equal to ee 

Less than < 

Less than or <= 
equal to 

Greater than > 

Greater than or >= 

equal to 


BOOLEAN 
Logical complement NOT $s 4 NOTA 0 if Ais non-zero 
1 if Ais zero 
Logical AND AND Y 3 AANDB Aff Bis nonzero 
0 if Bis zero 
Logical OR OR U 2 AOR B 1 if Bis non-zero 
Ait Bis zero 


STRING OPERATORS 


Example: “BUG” + “OFF” =“BUGOFF" 

Parentheses Defines slicing operation result. 
Examples: “ABC” + “DEF” (1 TO 5) = “ABCDE"’ 
(“ABC + DEF") (1 TO 2)=“AB" 


Slicing Obtains a substring from a string. 
Format: expr$ ({ start} TO {finish}) 
Example: ““ABCDEF"' (2 TO 5)="“BCDE” 


Concatenation Joins together two strings. 
Format: expr$; + expr$o 


STRING AND NUMBER VALUED BOOLEAN RELATIONS 


CAPS SHIFT and 6 (when editing) 
CAPS SHIFT and 7 (when editing) 
CAPS SHIFT and 8 

CAPS SHIFT and 9 

ENTER 


LIST (line) 


Moves the cursor > down one position. 
Moves the cursor > up one position. 
Moves the cursor to the right one position. 
Causes graphic mode entry or exit. 


Enters present line into memory, retrieves program listing on 
screen or indicates end of input. 


Causes the program in memory to be listed al the first line or from 
the specified line number. If screen filled, the query SCROLL? will 
appear at the bottom of the screen. If any key other than n (for 
No), BREAK, or STOP entered, the next 22 lines will be displayed. 


Causes cursor to move to right one position each time this bar is 
pressed. 


X$ AND Y X$ if Y is non-zero, 
‘’* (ampty string) if Y is zero, 
CASSETTE OPERATIONS 
PROGRAM LOADING PROGRAM SAVING VERIFYING A SAVE 
1. Obtain cursor on your | 1. Position tape in recorder. 1. Rewind the recorder to the 
screen and insure tape is 2. Connect MIC socket of com- place where SAVE began 
rewound to the beginning of puter to the microphone . Be sure the EAR sockets 


program. socket of recorder. 


2. Make sure both recorder & | 3. Press SAVE “program 
computer are EAR to EAR. name" or Save “program 


tse name" line number and 
8. hauled — press ENTER, If line 


specified, the program will 
4. Start cassette recorder by automatically begin execu- 
pressing PLAY on recorder tion at the specified line 
and then press ENTER on number. 
your computer. 4. Computer displays message 
5. Receive report of 0 OK, 0:1 “Start tape then press any 
or a title screen and/or user key.” 


on the computer and 
recorder are connected. 


. Press VERIFY ‘‘program 


name" or VERIFY ‘*" 


. Start cassette recorder and 


press ENTER in PLAY mode. 


. If the program is verified, 


the_.report code @ OK will 
appear on the screen, 


Program Loading (cont’d) Program Saving (cont'd) 


5. Start the recorder on 
RECORD and PLAY then 
press any key on the 


instructions when loading 
completed successfully. 

6. Stop recorder. 

7. Press RUN and ENTER to 
execute program if program 


keyboard. 


6. Receive report code 0 OK, 


TIMEX COMMAND 


1. Turn off the T/S 2068. 
2. Lift the cartridge door. 
3 


. Insert the Command Cartridge, 


with the label side up. 


: he 0:1 on screen when saving | 4. Close the cartridge door. 
saaaier we successfully completed. | 5. Turn on the T/S 2068. 
, 7. Stop recorder. 6. The program will begin. 


SYSTEM COMMANDS 


These commands result in the computer performing an operation at the system level. The com- 
mands are normally entered without a line number; however, they can be used in a program by 


prefixing the command with a line number, 


BREAK Can be used as a space bar for 
editing or to suspend program execution 
Resume execution by pressing SPACE bar or 
CONT. 

Format: BREAK 
Note: BREAK only works when the program is 
not waiting for input. Has to have CAPS SHIFT 
pressed with it to break the program. 
CLEAR Deletes all variables, freeing the 
space they occupied, but leaves the program 
in the computer. 

Format: CLEAR [exprnm] 
CONT CONTinues execution at the next in 
struction following a BREAK or STOP; restarts 
a program or lets you continue when the 
screen is full. 

Format: CONT 
COPY Prints the contents of the top 22 lines 
of the display to the printer, if attached; other- 
wise does nothing. 

Format: COPY 
DELETE Erases the specified range of lines 
from the program. 

Format: DELETE [line,], [lines] 
Note: If line,, not specified, all lines through 
line, deleted. If line, not specified, program 
lines from line, to end of the program are 
deleted. 
LIST Displays up to twenty-two lines of a 
specified portion of the program currently in 
memory, starting at the indicated line, or the 
beginning of the program, and makes the first 
line or indicated line number the current line. 

Format: LIST { fine } 
LLIST Lists all or starts from a specified 
portion of the program currently in memory on 
the printer, starting at the indicated line. 
Format: LLIST { fine } 
LOAD Loads the first program or a specified 
program on cassette in memory. 


Format:SLOAD“ t 
LOAD “program name” 


Copyright © 1983 by John Wiley and Sons, Inc. 


Designed by Werner Graphics 


Note: LOAD can be used to load variable 
information. 


Format: LOAD expr$ parameter 
where: 


parameter result of loading/saving 


DATA( ) numeric array 

DATAS ) — string array 

CODEm,n _ nbytes, starting at address m 
CODE m bytes starting at address m 


CODE bytes back into the address 
where they were saved from 


screen of information 


Example: LOAD "TABLE" DATAA( ) 

loads array named A from tape stored 

under the name TABLE 
MERGE Merges the specified program with 
the program currently in memory, 

Format: | MERGE" 

. MERGE "‘program name” 

NEW Starts the basic system off anew 
deleting the current program and all 
variables from memory. 

Format: NEW 


RUN Clears all variables and executes the 
current program in memory. If a line number is 
specified, execution commences at that line 
number; otherwise execution begins at the first 
line in the program. 

Format: RUN [line] 
SAVE Saves the program currently in 
memory on cassette with the designated 
program name. 
Note: SAVE can be used to save variable infor- 
mation. See table under LOAD, 


Format: SAVE “program name" 
Example: SAVE “TABLE" DATAA( ) 
Saves array named A on tape under the 
name TABLE 
VERIFY Compares a program on cassette 
previously saved with the version in memory. 
Format: VERIFY “program name” 


ISBN 0 471-80432-0 


CARTRIDGE™ OPERATIONS 


BASIC LANGUAGE STATEMENTS 


These statements result in the computer performing an operation when the program is executed. 
They are normally entered with a preceding line number; however, a statement may be used as a 


command by entering it without a line number. 


GOSUB Results in a branch to the 
subroutine at a specified line number. A 
RETURN statement causes a branch back to 
the instruction following the GOSUB. 

Format: GOSUB exprnm 

Example: line GOSUB 500 
QGOTO Causes an unconditional branch to 
the line number, or if there is none, to the first 
line after that. 

Format: GOTO exprnm 

Examples: fine GOTO 500 
Note: When used in immediate mode, GOTO 
starts a program at any line you choose 
without clearing the variables. 


1F-THEN Causes the execution of a state- 
ment if the indicated expression is true. If not 
true, the rest of the line is ignored and the 
program moves onto the next line. 
Format: IF expr THEN statement 
Example: line IF K=41 THEN GOTO 200 
RETURN Results in a program branch to the 
statement immediately following the most 
recently executed GOSUB statement. 
Format: RETURN 
Example: line RETURN 
Note: RETURN appears as RETRN on the 
keyboard. 


ON ERR GOTO Causes a transfer to the 
specified line number when an error 
occurs in the program. 

Format: ON ERR GOTO line 

Example: line ON ERR GOTO 5000 
Note: Error number obtained by PEEKing loca- 
tion 23739. Line number where error occurred 
obtained by PEEKing location 23736-23737. 
ON ERR CONT Causes the program to 
resume execution at the statement in which 
the error originally occurred. 


Format: ON ERR CONT 

Example: Jine ON ERR CONT 
ON ERR RESET Disables the ON ERR 
CONT statement which causes the program to 
resume reporting errors and terminate in the 
usual manner. 

Format: ON ERR RESET 

Example: line ON ERR RESET 


PROCESSING STATEMENTS 


CLS Clear Screen clears the display file that 
is the memory copy of the television picture. 
The program remains in memory. 

Format: CLS 

Example: line CLS 
DATA Creates a list of numeric and string 
constants to be assigned to variables through 
the use of the READ statement. 

Format: DATA constant (, constant) 

Example: line DATA 5, 25, “ART” 
DEF FN Allows user-defined function 
definitions. 


DEF FN letter (letter) =exprnm 
DEF FN letter ¢ (/etter$) = expr$ 


Example: line DEF FN A(x)=X13 + 4*X + 2 


DIM Deletes an array or string that has the 
indicated name if it previously existed and 
sets up an array of numbers or characters in 
bytes. 


Format: 


DIM letter (n,;. . n,) 
DIM letter$ (n,n) 

Examples: line DIM A(10,5) 

line DIM C $(5,10) 

FOR Initiates a loop that repeats execution 
of all instructions bounded by the NEXT state- 
ment until the automatically incremented or 
decremented “'step”’ variable attains the value 
exprnms. 

Format: FOR letter = exprnm, TO 

exprnms [STEP exprnm3)} 

Example: line FOR A= 50 TO 100 STEP 10 


Format: 


Note: If STEP omitted, exprnm, assumed to 
have a value of 1. 
LET Assigns a value or a string to the 
specified variable. 

Format: LET var = expr 

Example: line LET X= 4*A+3*B 
NEXT Terminates the loop initiated by a 
FOR statement. 

Format: NEXT /etter 

Example: line NEXT X 
PAUSE Stops computing and displays the 
display file for n frames (at 60 frames per sec- 
ond) or until a key is pressed. 

Format: PAUSE exprnm 

where: 0<exprnm s 65535 

Example: line PAUSE 500 
POKE Writes the value exprnm to the byte in 
storage at the indicated memory address. 

Format: POKE memadr, exprnm 

where: Os exprnms 255 

0s memaors 65535 

Example: line POKE 16514,102 
RANDOMIZE Statement that controls the 
randomness of the RND function by starting 
RND off at the denoted place. 

Format: RANDOMIZE [exprnm] 

where: 1s exprnms 65535 starts RND off 

at a definite place. 

when: exprnm = 0 RND starts based upon 

how long the television has been on. 

Example: fine RAND 35 
Note: RANDOMIZE appears as RAND on the 
keyboard. 


PROCESSING STATEMENTS (continued) 


READ Reads the next item in the DATA list 
and assigns it to the specified variable in the 
READ list. 
Format: READ var[,var.. .] 
Example: line READ A,x,C$ 
REM Nonexecutable statement that permits 
remarks to be placed in the statement. 
Format: REM remark 
Example: /ine REM MY PROGRAM 
RESTORE Resets the data list to the begin- 
ning or to a specific line for use by the next 
READ statement. 
Format: RESTORE [line] 
Example: line RESTORE 200 
STICK Returns the position of a device con- 
nected to the computer's joystick port and 
whether or not its pushbutton was pushed. 
Format: STICK (device, player) 
where: device -1 is joystick 
device 2 is pushbotton 
player 1 is left joystick 
player 2 is right joystick 
Results returned 
Value Returned 


Pushbutton Status 
Being pushed 


Not being pushed 
Joystick Values Returned 


STOP Halts execution with report code 9. 
CONT will resume execution with the following 
line. 


Format: STOP 
Example: line STOP 


Note: If the cursor is in quotes, you must delete 
the left quote before STOP entered or it will be 
interpreted as a string and will not stop the 
program. 


INPUT/OUTPUT CONTROL 


INPUT Suspends program execution and 
waits for the user to enter a value that will be 
assigned to a variable in the variable list. Ifa 
prompt string is included, the string will be 
displayed. 

Format: INPUT ["Prompt’’;] var[var.. .] 

Example: line INPUT “Cost ='";C 
LPRINT Sends a line of text to the printer 


Format: LPRINT [AT n,m] [TAB m] [list] } - | Format: PRINT (AT n,m) (TAB m) mi | 
(] 


where: n denotes line, Osns21 
m denotes column, 0=m<31 

Note: Only column number has any 
effect. See PRINT for effect of TAB, 
COMMA, SEMICOLON, and APOSTROPHE. 
Printer prints a line 
1. After an LPRINT statement that does not 
end in a comma or a semicolon. 
2. When a comma or TAB requires a new line 
to be started. 
3. At the end of the program, if there is 
anything “‘left over" to be printed. 
4. Any time the print buffer reaches 32 
characters in length. 


Example: line LPRINT TAB 2;X;TAB25;Y 


OUT Writes the byte n to “port address’ m 
external to the computer's memory. 

Format OUT m,n 

where: 0<m<65535 

-255 =n =255 

Example: line OUT 255,62 
PRINT Outputs values to the display file for 
display on the television. 


where: n denotes line, O<n<21 

m denotes column, 0<m<31 
AT Moves PRINT position to the line and 
coluinn specified. 
TAB Moves PRINT position to the column 
specified. 
{,] COMMA Moves the beginning of the 
next item to be displayed to position 0 on 
the next line. 
[;] SEMICOLON Continues display 
immediately after previous output 
displayed. 
['] APOSTROPHE Moves the print 
position to the beginning of the next line. 
Example: Jine PRINT TAB10:X;Y:Z$ 


AUDIO CONTROL 


BEEP Sounds a note through the computer's 
loudspeaker for the number of seconds 
specified exprnm, . The pitch is specified by 
exprnm,. The pitch is the number of semi- 
tones above middle C if a positive number is 
specified or below if a negative number is 
specified. 

Format: BEEP exprnm, , exprnms 
~wheremO<exprim, < 10 (duration in seconds) 


—69sexprnm, 369 (pitch values) 

Pitch Values (exprnms ) 
Example: fine BEEP 5,0 
SOUND Controls 3-channel sound syn- 
thesizer by placing an appropriate value into 
up to 15 registers. 

Format: SOUND register, value 

[;register, value... .] 


AUDIO CONTROL (continued) 


Register Chart for Sound 


Finetune, Channel A 
Coarsetune, Channel A 
Finetune, Channel B 
Coarsetune, Channel B 


Amplitude Channel A 
Amplitude Channel B 
Amplitude Channel C 
(value 16 enables 


Finetune, Channel C envelope) 


Coarsetune, Channel C Finetune envelope period 
Noise (Higher value = lower Coarsetune envelope 
frequency) period 
Enable (Subtract from 63 Envelope shape 
to enable) (Add to zero to Enable) 
Tone: A=1 B=1C=4 Hold 1 Alternate 2 
Noise: A=8 B=16 C=32 Attack 4 Continue & 


Note: Attack 4 causes sound to swell to peak amplitude. Attack 0 causes sound to decay to zero 
amplitude. Alternate 2 causes attack pattern to alternate. Hold 1 Limits the period to 1 cycle of 
either attack or decay. Sound then remains at peak or zero volume until new command changes it. 
Continue 0 Causes value of other 3 parameters to last for 1 cycle and volume to drop to zero, Con- 
tinue 8 Causes other 3 parameters to repeat until terminated. 


C’o? Dtee FPG Gta? ata? 


\ Add 12 to each value to repeat one octave higher / 
\ Subtract 12 to repeat one octave lower / 


\ Tune Values For the Musical Scale 
> 


ER 


Note 


a — °S 
3 


Example: line SOUND 0,68;1,3;8,10;7.62 
line PAUSE 60 
line SOUND 0,0:8,0;7,0 


COLOR CODE TABLE 


Color# COLOR Color# COLOR 
Black Green 


Biue Cyan 
Red Yellow 
Magenta White 


Note: Color code of 8 for transparent or 9 for contrast 


COLOR CONTROL STATEMENTS 


BORDER Sets the color of the edge of the Example: line BORDER 3 


screen. Once set, it remains that color untila new Note: The BORDER key results in the BORDER 
color is specified or the computer is turned off. statement. 


Format: BORDER color# 


COLOR CONTROL STATEMENTS (continued) 


INK Sets the color of the printed characters 
and symbols to be displayed on the screen. 
Format: INK color# 
Example: line INK 0 
line PRINT INK 1; “WELCOME” 


Note: If used as a command the result is not 
visible until something is printed. When used in 
a program line, INK selects a color that re- 
mains until changed by a subsequent line or 
the computer is turned off. If used in an INPUT 
or PRINT statement, it changes the INK only in 
that statement. 

PAPER Clears the screen of any information 
and sets the screen color. If enter is pressed 
again the paper color will be set and print will 
appear. 


Format: PAPER color# 
Examples: PAPER 7 
line PRINT PAPER 1; “HELLO” 

Note: In a program line, PAPER takes effect on- 
ly when something is printed. If used in an 
INPUT or PRINT statement, it changes the 
PAPER color only in that statement. When 
specified as a command, the entire screen is 
changed to the new color when ENTER 
pressed twice. Paper color extended to entire 
screen after a CLS command or after an 
ENTER to recall the program listing to the 
screen. 


GRAPHICS AND VIDEO CONTROL 


BRIGHT Sets the brightness of characters 
subsequently displayed. 

Format: BRIGHT exprnm 

where: 


Value of exornm result 
0 normal 
bright 
transparent 


Example: line BRIGHT 1 
CIRCLE Draws an arc of a circle centered at 
x-coordinate, y-coordinate, with the specified 
radius. 

Format: CIRCLE [INK color#] 

x-coordinate, y-coordinate, radius 

Example: Line CIRCLE 125,90,30 
DRAW: Draws a line from the current plot 
position moving exprnm, pixels horizontally and 
exprnms pixels vertically. If exprnm, specified, 
it turns through an angle specified by it. 
Format: DRAW [INK color#;] exprnm, , 
exprnms[, exprnm3 } 
Example: line DRAW 50,50 
FLASH Defines whether characters will be 
flashing or steady 

Format: FLASH exprnm 


where: 
0 steady 


flash 

no change 
Example: line FLASH 1 

INVERSE Causes the dots in each 8-by-8 


character grid to be reversed so that those that 
were INK become PAPER and vice versa. 


Format: INVERSE exprnm 
where: 


exprnm result 


Normal video as INK 
color on PAPER color. 


Inverse video as PAPER color on 
INK color. 


Example: line INVERSE 1 
OVER: Controls overprinting for characters 
subsequently displayed. 

Format: OVER exprnm 

where: 


exprnm result 


Characters obliterate 
previous characters at that 


position. 
New characters are mixed 
in with old characters. 


Example: OVER 0 
PLOT: Places a small dot on the screen at 
the pixel coordinates defined by x-coordinate 
and y-coordinate; if color# not specified, the 
current INK color is used; if color# specified, 
the dot is displayed in that color. 
Format: PLOT [INK color#] x-coordinate, 
y-coordinate 
where @=<color#<9 
@<exprnm, =255 
Osexprnm, s175 
Example: line PLOT INK 3; 50, 60 


BASIC FUNCTIONS 


FUNCTION FORMAT AND DESCRIPTION 


ABS exprnm Returns the absolute value of a 
number. 


ACS exprnm Returns the Arccosine of an 
angle of exornm radians. 


ASH exprnm Returns the Arcsine of an angle 
of exornm radians. 


ATN exprnm Returns the Arctangent of an 
angle of exornm radians. 


ATTR (x,y) Returns a decimal number bet- 
ween 0 and 255 which can be broken down to 
reveal the INK and PAPER color of the 
specified display position and whether it is 
bright or flashing. 


If number = 128 position flashing 

If number < 128 position not flashing 

If number — 128 = 64 position bright 

If number — 128< >64 position not bright 


BASIC FUNCTIONS (continued) 


Subtracting 64 from number determines INK 
and PAPER colors as follows: 


LN exprnm Returns the natural logarithm of 
the specified number. 

PEEK memadr Returns the decimal value of 
the specified memory location. 

Pl Returns 3.14159265, which is the circum- 


ference in inches of a circle one inch 
across. 


* POINT (x,y) Returns 1 if a pixel at (x,y) is INK 
color, 0 if it is PAPER color. 


RND Returns a random number between 

® (which value it can take) and 1 (which it 
Example: If number —64=0, both INK and cannot). 

PAPER are black. If number —64=21,PAPERis $CREENS (n,m) Returns the character on the 
red, INK is cyan. screen at line n, column m, Gives the empty 
CHRS exprnm Returns the character (string String if the character is not recognized. 

value) whose code is exprnm. SGN exprnm Returns + 1 if exprnm is 
Normally 32 <exprnm =255. positive, — 1 if negative, and 0 if its value is 
CODE expr$ Returns the code of the first zero. 

character in the string or 0 if the string is empty. $1N exprnm Returns the Sine of an angle of 
COS exprnm Returns the Cosine of an angle &xPrnm radians. 

of exprnm radians. SQR exprnm Returns the square root. 

EXP exprnm Returns the base of the natural ¢T R$ exprnm Converts a numeric value to a 
logarithm (e) raised to the specified power. string. 

FREE none Returns the number of bytes 
available for BASIC programs and variables. 


IN exprnm Reads from a ‘‘port address” 
external to the T/S 2068's memory. 
Osexprnm =FFFFh, 


TAN exprnm Returns the tangent of an angle 
of exprnm radians. 


USR exprnm Calls the machine code 
subroutine whose starting address is exprnm. 


; VAL expr$ Evaluates a numeric expression 
INKEY$ var Receives one character fromthe without its bounding quotes as a numeric 
keyboard representing the key pressed, else expression. 


the emply string. y en ; ; 

: ALS expr$ Evaluates a numeric expression 
INT exprnm Returns the integer part (always —_ without its bounding quotes as a string 
rounded down) of a number. expression. 


LEN expr Returns the length of the specified 
string. 


CHARACTER GRAPHICS 


SCREEN FORMAT 


Permits characters to include letters, digits, 
punctuation marks, and graphic symbols to be 
displayed in any of 704 distinct locations tt 
(32 columns and 22 lines) on the screen. Hine HitE 
H H rH 
Corr 
COCO 
= 


attributes to consider 


attribute attribute paramters 


| «fl BRIGHT 
line PRINT [ AT n,m][TAB m] [Attribute;] [list] } Al FLASH 


(] 


DISPLAY STATEMENTS 


INK 
INVERSE 
OVER 


line INPUT [attribute:] [“prompt":] var (var... ] PAPER 


GRAPHIC SYMBOLS 


Graphic symbols on the numeric keys are obtained by pressing CAPS SHIFT and 9 to enter 
Graphics mode. Then press the numeric key to display the graphic symbol on that key. 


Symbol Numeric Key Symbol Numeric Key 


PIXEL (PICTURE ELEMENT) GRAPHICS 


Permits individual points to be colored in any of 45,056 distinct locations (256 x-coordinates and 
176 y-coordinates) on the screen using the PLOT statement. Also permits circles and lines to be 
drawn using the CIRCLE and DRAW statements. 


SCREEN FORMAT 
175 


Pixel 
y-coordinates 


0 ; = 0 
Pixel x-coordinates 255 
DISPLAY STATEMENTS 


line CIRCLE [INK color#;] x-coordinate, y-coordinate, radius 
line DRAW [INK color#;] x-coordinate, y-coordinate, angle 
line PLOT [INK colorf;] x-coordinate, y-coordinate 


TIMEX SINCLAIR 2068 REPORT CODES 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
Cc 
D 


OK 

NEXT without FOR 
Variable not found 
Subscript wrong 

Out of memory 

Out of screen 
Number too big 
RETURN without GOSUB 
End of file 

STOP statement 
Invalid argument 
Integer out of range 
Invalid string 
BREAK-CONT repeat 


DOVOZZrAc—-TAOH™|! 


Out of DATA 
Invalid file name 
No room for line 
STOP in input 

FOR without NEXT 
Invalid I/O device 
Invalid color 
BREAK into program 
RAM TOP no good 
Statement loss 
Invalid string 

FN without DEF 
Perimeter error 
Tape loading error 


